<html><body>
<style>

body, h1, h2, h3, div, span, p, pre, a {
  margin: 0;
  padding: 0;
  border: 0;
  font-weight: inherit;
  font-style: inherit;
  font-size: 100%;
  font-family: inherit;
  vertical-align: baseline;
}

body {
  font-size: 13px;
  padding: 1em;
}

h1 {
  font-size: 26px;
  margin-bottom: 1em;
}

h2 {
  font-size: 24px;
  margin-bottom: 1em;
}

h3 {
  font-size: 20px;
  margin-bottom: 1em;
  margin-top: 1em;
}

pre, code {
  line-height: 1.5;
  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}

pre {
  margin-top: 0.5em;
}

h1, h2, h3, p {
  font-family: Arial, sans serif;
}

h1, h2, h3 {
  border-bottom: solid #CCC 1px;
}

.toc_element {
  margin-top: 0.5em;
}

.firstline {
  margin-left: 2 em;
}

.method  {
  margin-top: 1em;
  border: solid 1px #CCC;
  padding: 1em;
  background: #EEE;
}

.details {
  font-weight: bold;
  font-size: 14px;
}

</style>

<h1><a href="dataplex_v1.html">Cloud Dataplex API</a> . <a href="dataplex_v1.projects.html">projects</a> . <a href="dataplex_v1.projects.locations.html">locations</a> . <a href="dataplex_v1.projects.locations.metadataJobs.html">metadataJobs</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#cancel">cancel(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Cancels a metadata job.If you cancel a metadata import job that is in progress, the changes in the job might be partially applied. We recommend that you reset the state of the entry groups in your project by running another metadata job that reverts the changes from the canceled job.</p>
<p class="toc_element">
  <code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
  <code><a href="#create">create(parent, body=None, metadataJobId=None, validateOnly=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a metadata job. For example, use a metadata job to import metadata from a third-party system into Dataplex Universal Catalog.</p>
<p class="toc_element">
  <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a metadata job.</p>
<p class="toc_element">
  <code><a href="#list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists metadata jobs.</p>
<p class="toc_element">
  <code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="cancel">cancel(name, body=None, x__xgafv=None)</code>
  <pre>Cancels a metadata job.If you cancel a metadata import job that is in progress, the changes in the job might be partially applied. We recommend that you reset the state of the entry groups in your project by running another metadata job that reverts the changes from the canceled job.

Args:
  name: string, Required. The resource name of the job, in the format projects/{project_id_or_number}/locations/{location_id}/metadataJobs/{metadata_job_id} (required)
  body: object, The request body.
    The object takes the form of:

{ # Cancel metadata job request.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}</pre>
</div>

<div class="method">
    <code class="details" id="close">close()</code>
  <pre>Close httplib2 connections.</pre>
</div>

<div class="method">
    <code class="details" id="create">create(parent, body=None, metadataJobId=None, validateOnly=None, x__xgafv=None)</code>
  <pre>Creates a metadata job. For example, use a metadata job to import metadata from a third-party system into Dataplex Universal Catalog.

Args:
  parent: string, Required. The resource name of the parent location, in the format projects/{project_id_or_number}/locations/{location_id} (required)
  body: object, The request body.
    The object takes the form of:

{ # A metadata job resource.
  &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the metadata job was created.
  &quot;exportResult&quot;: { # Summary results from a metadata export job. The results are a snapshot of the metadata at the time when the job was created. The exported entries are saved to a Cloud Storage bucket. # Output only. Export job result.
    &quot;errorMessage&quot;: &quot;A String&quot;, # Output only. The error message if the metadata export job failed.
    &quot;exportedEntries&quot;: &quot;A String&quot;, # Output only. The number of entries that were exported.
  },
  &quot;exportSpec&quot;: { # Job specification for a metadata export job. # Export job specification.
    &quot;outputPath&quot;: &quot;A String&quot;, # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex Universal Catalog constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
    &quot;scope&quot;: { # The scope of the export job. # Required. The scope of the export job.
      &quot;aspectTypes&quot;: [ # The aspect types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/aspectTypes/{aspect_type_id}. Only aspects that belong to the specified aspect types are affected by the job.
        &quot;A String&quot;,
      ],
      &quot;entryGroups&quot;: [ # The entry groups whose metadata you want to export, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}. Only the entries in the specified entry groups are exported.The entry groups must be in the same location and the same VPC Service Controls perimeter as the job.If you set the job scope to be a list of entry groups, then set the organization-level export flag to false and don&#x27;t provide a list of projects.
        &quot;A String&quot;,
      ],
      &quot;entryTypes&quot;: [ # The entry types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/entryTypes/{entry_type_id}. Only entries that belong to the specified entry types are affected by the job.
        &quot;A String&quot;,
      ],
      &quot;organizationLevel&quot;: True or False, # Whether the metadata export job is an organization-level export job. If true, the job exports the entries from the same organization and VPC Service Controls perimeter as the job. The project that the job belongs to determines the VPC Service Controls perimeter. If you set the job scope to be at the organization level, then don&#x27;t provide a list of projects or entry groups. If false, you must specify a list of projects or a list of entry groups whose entries you want to export.The default is false.
      &quot;projects&quot;: [ # The projects whose metadata you want to export, in the format projects/{project_id_or_number}. Only the entries from the specified projects are exported.The projects must be in the same organization and VPC Service Controls perimeter as the job.If you set the job scope to be a list of projects, then set the organization-level export flag to false and don&#x27;t provide a list of entry groups.
        &quot;A String&quot;,
      ],
    },
  },
  &quot;importResult&quot;: { # Results from a metadata import job. # Output only. Import job result.
    &quot;createdEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were created.
    &quot;createdEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were successfully created.
    &quot;deletedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were deleted.
    &quot;deletedEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were successfully deleted.
    &quot;recreatedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were recreated.
    &quot;unchangedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were unchanged.
    &quot;unchangedEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were left unchanged.
    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the status was updated.
    &quot;updatedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were updated.
  },
  &quot;importSpec&quot;: { # Job specification for a metadata import job.You can run the following kinds of metadata import jobs: Full sync of entries with incremental import of their aspects. Supported for custom entries. Incremental import of aspects only. Supported for aspects that belong to custom entries and system entries. For custom entries, you can modify both optional aspects and required aspects. For system entries, you can modify optional aspects. # Import job specification.
    &quot;aspectSyncMode&quot;: &quot;A String&quot;, # Required. The sync mode for aspects.
    &quot;entrySyncMode&quot;: &quot;A String&quot;, # Required. The sync mode for entries.
    &quot;logLevel&quot;: &quot;A String&quot;, # Optional. The level of logs to write to Cloud Logging for this job.Debug-level logs provide highly-detailed information for troubleshooting, but their increased verbosity could incur additional costs (https://cloud.google.com/stackdriver/pricing) that might not be merited for all jobs.If unspecified, defaults to INFO.
    &quot;scope&quot;: { # A boundary on the scope of impact that the metadata import job can have. # Required. A boundary on the scope of impact that the metadata import job can have.
      &quot;aspectTypes&quot;: [ # Optional. The aspect types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}. The job modifies only the aspects that belong to these aspect types.This field is required when creating an aspect-only import job.If the metadata import file attempts to modify an aspect whose type isn&#x27;t included in this list, the import job is halted before modifying any entries or aspects.The location of an aspect type must either match the location of the job, or the aspect type must be global.
        &quot;A String&quot;,
      ],
      &quot;entryGroups&quot;: [ # Required. The entry groups that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}. Only entries and aspects that belong to the specified entry groups are affected by the job.The entry groups and the job must be in the same location.
        &quot;A String&quot;,
      ],
      &quot;entryLinkTypes&quot;: [ # Optional. The entry link types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryLinkTypes/{entry_link_type_id}. The job modifies only the entryLinks that belong to these entry link types.If the metadata import file attempts to create or delete an entry link whose entry link type isn&#x27;t included in this list, the import job will skip those entry links.
        &quot;A String&quot;,
      ],
      &quot;entryTypes&quot;: [ # Required. The entry types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}. The job modifies only the entries and aspects that belong to these entry types.If the metadata import file attempts to modify an entry whose type isn&#x27;t included in this list, the import job is halted before modifying any entries or aspects.The location of an entry type must either match the location of the job, or the entry type must be global.
        &quot;A String&quot;,
      ],
      &quot;glossaries&quot;: [ # Optional. The glossaries that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/glossaries/{glossary_id}.While importing Business Glossary entries, the user must provide glossaries. While importing entries, the user does not have to provide glossaries. If the metadata import file attempts to modify Business Glossary entries whose glossary isn&#x27;t included in this list, the import job will skip those entries.The location of a glossary must either match the location of the job, or the glossary must be global.
        &quot;A String&quot;,
      ],
      &quot;referencedEntryScopes&quot;: [ # Optional. Defines the scope of entries that can be referenced in the entry links.Currently, projects are supported as valid scopes. Format: projects/{project_number_or_id}If the metadata import file attempts to create an entry link which references an entry that is not in the scope, the import job will skip that entry link.
        &quot;A String&quot;,
      ],
    },
    &quot;sourceCreateTime&quot;: &quot;A String&quot;, # Optional. The time when the process that created the metadata import files began.
    &quot;sourceStorageUri&quot;: &quot;A String&quot;, # Optional. The URI of a Cloud Storage bucket or folder (beginning with gs:// and ending with /) that contains the metadata import files for this job.A metadata import file defines the values to set for each of the entries and aspects in a metadata import job. For more information about how to create a metadata import file and the file requirements, see Metadata import file (https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).You can provide multiple metadata import files in the same metadata job. The bucket or folder must contain at least one metadata import file, in JSON Lines format (either .json or .jsonl file extension).In FULL entry sync mode, don&#x27;t save the metadata import file in a folder named SOURCE_STORAGE_URI/deletions/.Caution: If the metadata import file contains no data, all entries and aspects that belong to the job&#x27;s scope are deleted.
  },
  &quot;labels&quot;: { # Optional. User-defined labels.
    &quot;a_key&quot;: &quot;A String&quot;,
  },
  &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The name of the resource that the configuration is applied to, in the format projects/{project_number}/locations/{location_id}/metadataJobs/{metadata_job_id}.
  &quot;status&quot;: { # Metadata job status. # Output only. Metadata job status.
    &quot;completionPercent&quot;: 42, # Output only. Progress tracking.
    &quot;message&quot;: &quot;A String&quot;, # Output only. Message relating to the progression of a metadata job.
    &quot;state&quot;: &quot;A String&quot;, # Output only. State of the metadata job.
    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the status was updated.
  },
  &quot;type&quot;: &quot;A String&quot;, # Required. Metadata job type.
  &quot;uid&quot;: &quot;A String&quot;, # Output only. A system-generated, globally unique ID for the metadata job. If the metadata job is deleted and then re-created with the same name, this ID is different.
  &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the metadata job was updated.
}

  metadataJobId: string, Optional. The metadata job ID. If not provided, a unique ID is generated with the prefix metadata-job-.
  validateOnly: boolean, Optional. The service validates the request without performing any mutations. The default is false.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # This resource represents a long-running operation that is the result of a network API call.
  &quot;done&quot;: True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
  &quot;error&quot;: { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
    &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
    &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
      {
        &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
      },
    ],
    &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
  },
  &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
    &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
  },
  &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.
  &quot;response&quot;: { # The normal, successful response of the operation. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
    &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
  },
}</pre>
</div>

<div class="method">
    <code class="details" id="get">get(name, x__xgafv=None)</code>
  <pre>Gets a metadata job.

Args:
  name: string, Required. The resource name of the metadata job, in the format projects/{project_id_or_number}/locations/{location_id}/metadataJobs/{metadata_job_id}. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A metadata job resource.
  &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the metadata job was created.
  &quot;exportResult&quot;: { # Summary results from a metadata export job. The results are a snapshot of the metadata at the time when the job was created. The exported entries are saved to a Cloud Storage bucket. # Output only. Export job result.
    &quot;errorMessage&quot;: &quot;A String&quot;, # Output only. The error message if the metadata export job failed.
    &quot;exportedEntries&quot;: &quot;A String&quot;, # Output only. The number of entries that were exported.
  },
  &quot;exportSpec&quot;: { # Job specification for a metadata export job. # Export job specification.
    &quot;outputPath&quot;: &quot;A String&quot;, # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex Universal Catalog constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
    &quot;scope&quot;: { # The scope of the export job. # Required. The scope of the export job.
      &quot;aspectTypes&quot;: [ # The aspect types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/aspectTypes/{aspect_type_id}. Only aspects that belong to the specified aspect types are affected by the job.
        &quot;A String&quot;,
      ],
      &quot;entryGroups&quot;: [ # The entry groups whose metadata you want to export, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}. Only the entries in the specified entry groups are exported.The entry groups must be in the same location and the same VPC Service Controls perimeter as the job.If you set the job scope to be a list of entry groups, then set the organization-level export flag to false and don&#x27;t provide a list of projects.
        &quot;A String&quot;,
      ],
      &quot;entryTypes&quot;: [ # The entry types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/entryTypes/{entry_type_id}. Only entries that belong to the specified entry types are affected by the job.
        &quot;A String&quot;,
      ],
      &quot;organizationLevel&quot;: True or False, # Whether the metadata export job is an organization-level export job. If true, the job exports the entries from the same organization and VPC Service Controls perimeter as the job. The project that the job belongs to determines the VPC Service Controls perimeter. If you set the job scope to be at the organization level, then don&#x27;t provide a list of projects or entry groups. If false, you must specify a list of projects or a list of entry groups whose entries you want to export.The default is false.
      &quot;projects&quot;: [ # The projects whose metadata you want to export, in the format projects/{project_id_or_number}. Only the entries from the specified projects are exported.The projects must be in the same organization and VPC Service Controls perimeter as the job.If you set the job scope to be a list of projects, then set the organization-level export flag to false and don&#x27;t provide a list of entry groups.
        &quot;A String&quot;,
      ],
    },
  },
  &quot;importResult&quot;: { # Results from a metadata import job. # Output only. Import job result.
    &quot;createdEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were created.
    &quot;createdEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were successfully created.
    &quot;deletedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were deleted.
    &quot;deletedEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were successfully deleted.
    &quot;recreatedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were recreated.
    &quot;unchangedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were unchanged.
    &quot;unchangedEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were left unchanged.
    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the status was updated.
    &quot;updatedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were updated.
  },
  &quot;importSpec&quot;: { # Job specification for a metadata import job.You can run the following kinds of metadata import jobs: Full sync of entries with incremental import of their aspects. Supported for custom entries. Incremental import of aspects only. Supported for aspects that belong to custom entries and system entries. For custom entries, you can modify both optional aspects and required aspects. For system entries, you can modify optional aspects. # Import job specification.
    &quot;aspectSyncMode&quot;: &quot;A String&quot;, # Required. The sync mode for aspects.
    &quot;entrySyncMode&quot;: &quot;A String&quot;, # Required. The sync mode for entries.
    &quot;logLevel&quot;: &quot;A String&quot;, # Optional. The level of logs to write to Cloud Logging for this job.Debug-level logs provide highly-detailed information for troubleshooting, but their increased verbosity could incur additional costs (https://cloud.google.com/stackdriver/pricing) that might not be merited for all jobs.If unspecified, defaults to INFO.
    &quot;scope&quot;: { # A boundary on the scope of impact that the metadata import job can have. # Required. A boundary on the scope of impact that the metadata import job can have.
      &quot;aspectTypes&quot;: [ # Optional. The aspect types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}. The job modifies only the aspects that belong to these aspect types.This field is required when creating an aspect-only import job.If the metadata import file attempts to modify an aspect whose type isn&#x27;t included in this list, the import job is halted before modifying any entries or aspects.The location of an aspect type must either match the location of the job, or the aspect type must be global.
        &quot;A String&quot;,
      ],
      &quot;entryGroups&quot;: [ # Required. The entry groups that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}. Only entries and aspects that belong to the specified entry groups are affected by the job.The entry groups and the job must be in the same location.
        &quot;A String&quot;,
      ],
      &quot;entryLinkTypes&quot;: [ # Optional. The entry link types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryLinkTypes/{entry_link_type_id}. The job modifies only the entryLinks that belong to these entry link types.If the metadata import file attempts to create or delete an entry link whose entry link type isn&#x27;t included in this list, the import job will skip those entry links.
        &quot;A String&quot;,
      ],
      &quot;entryTypes&quot;: [ # Required. The entry types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}. The job modifies only the entries and aspects that belong to these entry types.If the metadata import file attempts to modify an entry whose type isn&#x27;t included in this list, the import job is halted before modifying any entries or aspects.The location of an entry type must either match the location of the job, or the entry type must be global.
        &quot;A String&quot;,
      ],
      &quot;glossaries&quot;: [ # Optional. The glossaries that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/glossaries/{glossary_id}.While importing Business Glossary entries, the user must provide glossaries. While importing entries, the user does not have to provide glossaries. If the metadata import file attempts to modify Business Glossary entries whose glossary isn&#x27;t included in this list, the import job will skip those entries.The location of a glossary must either match the location of the job, or the glossary must be global.
        &quot;A String&quot;,
      ],
      &quot;referencedEntryScopes&quot;: [ # Optional. Defines the scope of entries that can be referenced in the entry links.Currently, projects are supported as valid scopes. Format: projects/{project_number_or_id}If the metadata import file attempts to create an entry link which references an entry that is not in the scope, the import job will skip that entry link.
        &quot;A String&quot;,
      ],
    },
    &quot;sourceCreateTime&quot;: &quot;A String&quot;, # Optional. The time when the process that created the metadata import files began.
    &quot;sourceStorageUri&quot;: &quot;A String&quot;, # Optional. The URI of a Cloud Storage bucket or folder (beginning with gs:// and ending with /) that contains the metadata import files for this job.A metadata import file defines the values to set for each of the entries and aspects in a metadata import job. For more information about how to create a metadata import file and the file requirements, see Metadata import file (https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).You can provide multiple metadata import files in the same metadata job. The bucket or folder must contain at least one metadata import file, in JSON Lines format (either .json or .jsonl file extension).In FULL entry sync mode, don&#x27;t save the metadata import file in a folder named SOURCE_STORAGE_URI/deletions/.Caution: If the metadata import file contains no data, all entries and aspects that belong to the job&#x27;s scope are deleted.
  },
  &quot;labels&quot;: { # Optional. User-defined labels.
    &quot;a_key&quot;: &quot;A String&quot;,
  },
  &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The name of the resource that the configuration is applied to, in the format projects/{project_number}/locations/{location_id}/metadataJobs/{metadata_job_id}.
  &quot;status&quot;: { # Metadata job status. # Output only. Metadata job status.
    &quot;completionPercent&quot;: 42, # Output only. Progress tracking.
    &quot;message&quot;: &quot;A String&quot;, # Output only. Message relating to the progression of a metadata job.
    &quot;state&quot;: &quot;A String&quot;, # Output only. State of the metadata job.
    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the status was updated.
  },
  &quot;type&quot;: &quot;A String&quot;, # Required. Metadata job type.
  &quot;uid&quot;: &quot;A String&quot;, # Output only. A system-generated, globally unique ID for the metadata job. If the metadata job is deleted and then re-created with the same name, this ID is different.
  &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the metadata job was updated.
}</pre>
</div>

<div class="method">
    <code class="details" id="list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
  <pre>Lists metadata jobs.

Args:
  parent: string, Required. The resource name of the parent location, in the format projects/{project_id_or_number}/locations/{location_id} (required)
  filter: string, Optional. Filter request. Filters are case-sensitive. The service supports the following formats: labels.key1 = &quot;value1&quot; labels:key1 name = &quot;value&quot;You can combine filters with AND, OR, and NOT operators.
  orderBy: string, Optional. The field to sort the results by, either name or create_time. If not specified, the ordering is undefined.
  pageSize: integer, Optional. The maximum number of metadata jobs to return. The service might return fewer jobs than this value. If unspecified, at most 10 jobs are returned. The maximum value is 1,000.
  pageToken: string, Optional. The page token received from a previous ListMetadataJobs call. Provide this token to retrieve the subsequent page of results. When paginating, all other parameters that are provided to the ListMetadataJobs request must match the call that provided the page token.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # List metadata jobs response.
  &quot;metadataJobs&quot;: [ # Metadata jobs under the specified parent location.
    { # A metadata job resource.
      &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the metadata job was created.
      &quot;exportResult&quot;: { # Summary results from a metadata export job. The results are a snapshot of the metadata at the time when the job was created. The exported entries are saved to a Cloud Storage bucket. # Output only. Export job result.
        &quot;errorMessage&quot;: &quot;A String&quot;, # Output only. The error message if the metadata export job failed.
        &quot;exportedEntries&quot;: &quot;A String&quot;, # Output only. The number of entries that were exported.
      },
      &quot;exportSpec&quot;: { # Job specification for a metadata export job. # Export job specification.
        &quot;outputPath&quot;: &quot;A String&quot;, # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex Universal Catalog constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
        &quot;scope&quot;: { # The scope of the export job. # Required. The scope of the export job.
          &quot;aspectTypes&quot;: [ # The aspect types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/aspectTypes/{aspect_type_id}. Only aspects that belong to the specified aspect types are affected by the job.
            &quot;A String&quot;,
          ],
          &quot;entryGroups&quot;: [ # The entry groups whose metadata you want to export, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}. Only the entries in the specified entry groups are exported.The entry groups must be in the same location and the same VPC Service Controls perimeter as the job.If you set the job scope to be a list of entry groups, then set the organization-level export flag to false and don&#x27;t provide a list of projects.
            &quot;A String&quot;,
          ],
          &quot;entryTypes&quot;: [ # The entry types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/entryTypes/{entry_type_id}. Only entries that belong to the specified entry types are affected by the job.
            &quot;A String&quot;,
          ],
          &quot;organizationLevel&quot;: True or False, # Whether the metadata export job is an organization-level export job. If true, the job exports the entries from the same organization and VPC Service Controls perimeter as the job. The project that the job belongs to determines the VPC Service Controls perimeter. If you set the job scope to be at the organization level, then don&#x27;t provide a list of projects or entry groups. If false, you must specify a list of projects or a list of entry groups whose entries you want to export.The default is false.
          &quot;projects&quot;: [ # The projects whose metadata you want to export, in the format projects/{project_id_or_number}. Only the entries from the specified projects are exported.The projects must be in the same organization and VPC Service Controls perimeter as the job.If you set the job scope to be a list of projects, then set the organization-level export flag to false and don&#x27;t provide a list of entry groups.
            &quot;A String&quot;,
          ],
        },
      },
      &quot;importResult&quot;: { # Results from a metadata import job. # Output only. Import job result.
        &quot;createdEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were created.
        &quot;createdEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were successfully created.
        &quot;deletedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were deleted.
        &quot;deletedEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were successfully deleted.
        &quot;recreatedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were recreated.
        &quot;unchangedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were unchanged.
        &quot;unchangedEntryLinks&quot;: &quot;A String&quot;, # Output only. The total number of entry links that were left unchanged.
        &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the status was updated.
        &quot;updatedEntries&quot;: &quot;A String&quot;, # Output only. The total number of entries that were updated.
      },
      &quot;importSpec&quot;: { # Job specification for a metadata import job.You can run the following kinds of metadata import jobs: Full sync of entries with incremental import of their aspects. Supported for custom entries. Incremental import of aspects only. Supported for aspects that belong to custom entries and system entries. For custom entries, you can modify both optional aspects and required aspects. For system entries, you can modify optional aspects. # Import job specification.
        &quot;aspectSyncMode&quot;: &quot;A String&quot;, # Required. The sync mode for aspects.
        &quot;entrySyncMode&quot;: &quot;A String&quot;, # Required. The sync mode for entries.
        &quot;logLevel&quot;: &quot;A String&quot;, # Optional. The level of logs to write to Cloud Logging for this job.Debug-level logs provide highly-detailed information for troubleshooting, but their increased verbosity could incur additional costs (https://cloud.google.com/stackdriver/pricing) that might not be merited for all jobs.If unspecified, defaults to INFO.
        &quot;scope&quot;: { # A boundary on the scope of impact that the metadata import job can have. # Required. A boundary on the scope of impact that the metadata import job can have.
          &quot;aspectTypes&quot;: [ # Optional. The aspect types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}. The job modifies only the aspects that belong to these aspect types.This field is required when creating an aspect-only import job.If the metadata import file attempts to modify an aspect whose type isn&#x27;t included in this list, the import job is halted before modifying any entries or aspects.The location of an aspect type must either match the location of the job, or the aspect type must be global.
            &quot;A String&quot;,
          ],
          &quot;entryGroups&quot;: [ # Required. The entry groups that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}. Only entries and aspects that belong to the specified entry groups are affected by the job.The entry groups and the job must be in the same location.
            &quot;A String&quot;,
          ],
          &quot;entryLinkTypes&quot;: [ # Optional. The entry link types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryLinkTypes/{entry_link_type_id}. The job modifies only the entryLinks that belong to these entry link types.If the metadata import file attempts to create or delete an entry link whose entry link type isn&#x27;t included in this list, the import job will skip those entry links.
            &quot;A String&quot;,
          ],
          &quot;entryTypes&quot;: [ # Required. The entry types that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}. The job modifies only the entries and aspects that belong to these entry types.If the metadata import file attempts to modify an entry whose type isn&#x27;t included in this list, the import job is halted before modifying any entries or aspects.The location of an entry type must either match the location of the job, or the entry type must be global.
            &quot;A String&quot;,
          ],
          &quot;glossaries&quot;: [ # Optional. The glossaries that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/glossaries/{glossary_id}.While importing Business Glossary entries, the user must provide glossaries. While importing entries, the user does not have to provide glossaries. If the metadata import file attempts to modify Business Glossary entries whose glossary isn&#x27;t included in this list, the import job will skip those entries.The location of a glossary must either match the location of the job, or the glossary must be global.
            &quot;A String&quot;,
          ],
          &quot;referencedEntryScopes&quot;: [ # Optional. Defines the scope of entries that can be referenced in the entry links.Currently, projects are supported as valid scopes. Format: projects/{project_number_or_id}If the metadata import file attempts to create an entry link which references an entry that is not in the scope, the import job will skip that entry link.
            &quot;A String&quot;,
          ],
        },
        &quot;sourceCreateTime&quot;: &quot;A String&quot;, # Optional. The time when the process that created the metadata import files began.
        &quot;sourceStorageUri&quot;: &quot;A String&quot;, # Optional. The URI of a Cloud Storage bucket or folder (beginning with gs:// and ending with /) that contains the metadata import files for this job.A metadata import file defines the values to set for each of the entries and aspects in a metadata import job. For more information about how to create a metadata import file and the file requirements, see Metadata import file (https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).You can provide multiple metadata import files in the same metadata job. The bucket or folder must contain at least one metadata import file, in JSON Lines format (either .json or .jsonl file extension).In FULL entry sync mode, don&#x27;t save the metadata import file in a folder named SOURCE_STORAGE_URI/deletions/.Caution: If the metadata import file contains no data, all entries and aspects that belong to the job&#x27;s scope are deleted.
      },
      &quot;labels&quot;: { # Optional. User-defined labels.
        &quot;a_key&quot;: &quot;A String&quot;,
      },
      &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The name of the resource that the configuration is applied to, in the format projects/{project_number}/locations/{location_id}/metadataJobs/{metadata_job_id}.
      &quot;status&quot;: { # Metadata job status. # Output only. Metadata job status.
        &quot;completionPercent&quot;: 42, # Output only. Progress tracking.
        &quot;message&quot;: &quot;A String&quot;, # Output only. Message relating to the progression of a metadata job.
        &quot;state&quot;: &quot;A String&quot;, # Output only. State of the metadata job.
        &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the status was updated.
      },
      &quot;type&quot;: &quot;A String&quot;, # Required. Metadata job type.
      &quot;uid&quot;: &quot;A String&quot;, # Output only. A system-generated, globally unique ID for the metadata job. If the metadata job is deleted and then re-created with the same name, this ID is different.
      &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the metadata job was updated.
    },
  ],
  &quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of results. If there are no more results in the list, the value is empty.
  &quot;unreachableLocations&quot;: [ # Locations that the service couldn&#x27;t reach.
    &quot;A String&quot;,
  ],
}</pre>
</div>

<div class="method">
    <code class="details" id="list_next">list_next()</code>
  <pre>Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call &#x27;execute()&#x27; on to request the next
          page. Returns None if there are no more items in the collection.
        </pre>
</div>

</body></html>